package cn.iocoder.yudao.module.eval.service.profession;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.eval.controller.admin.profession.vo.*;
import cn.iocoder.yudao.module.eval.dal.dataobject.profession.EvalProfessionDO;

import javax.validation.Valid;
import java.util.Collection;
import java.util.List;

/**
 * 职业工种 Service 接口
 *
 * @author 芋道源码
 */
public interface EvalProfessionService {

    /**
     * 创建职业工种
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createProfession(@Valid EvalProfessionSaveReqVO createReqVO);

    /**
     * 更新职业工种
     *
     * @param updateReqVO 更新信息
     */
    void updateProfession(@Valid EvalProfessionSaveReqVO updateReqVO);

    /**
     * 删除职业工种
     *
     * @param id 编号
     */
    void deleteProfession(Long id);

    /**
     * 获得职业工种
     *
     * @param id 编号
     * @return 职业工种
     */
    EvalProfessionDO getProfession(Long id);

    /**
     * 获得职业工种列表
     *
     * @param ids 编号
     * @return 职业工种列表
     */
    List<EvalProfessionDO> getProfessionList(Collection<Long> ids);

    /**
     * 获得职业工种分页
     *
     * @param pageReqVO 分页查询
     * @return 职业工种分页
     */
    PageResult<EvalProfessionDO> getProfessionPage(EvalProfessionPageReqVO pageReqVO);

    /**
     * 根据职业代码获得职业工种
     *
     * @param professionCode 职业代码
     * @return 职业工种
     */
    EvalProfessionDO getProfessionByCode(String professionCode);

    /**
     * 根据审核状态获得职业工种列表
     *
     * @param approvalStatus 审核状态
     * @return 职业工种列表
     */
    List<EvalProfessionDO> getProfessionListByApprovalStatus(Integer approvalStatus);

    /**
     * 根据职业大类获得职业工种列表
     *
     * @param category 职业大类
     * @return 职业工种列表
     */
    List<EvalProfessionDO> getProfessionListByCategory(String category);

    /**
     * 审核职业工种
     *
     * @param id 编号
     * @param approvalStatus 审核状态
     * @param approvalComments 审核意见
     */
    void auditProfession(Long id, Integer approvalStatus, String approvalComments);

    /**
     * 匹配职业工种
     *
     * @param keyword 关键词
     * @param category 职业大类
     * @return 匹配的职业工种列表
     */
    List<EvalProfessionRespVO> matchProfessions(String keyword, String category);

    /**
     * 搜索职业工种
     *
     * @param keyword 关键词
     * @return 职业工种列表
     */
    List<EvalProfessionRespVO> searchProfessions(String keyword);

    /**
     * 获取职业工种统计
     *
     * @return 统计信息
     */
    EvalProfessionStatisticsRespVO getProfessionStatistics();

    /**
     * 批量审核职业工种
     *
     * @param auditReqVOList 审核信息列表
     */
    void batchAuditProfessions(@Valid List<EvalProfessionAuditReqVO> auditReqVOList);

    /**
     * 更新职业工种状态
     *
     * @param id 编号
     * @param status 状态
     * @param reason 原因
     */
    void updateProfessionStatus(Long id, Integer status, String reason);

}
